home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / utilities / emulators / a64v2d2.lzh / Doc / Utilities < prev    next >
Text File  |  1991-10-02  |  25KB  |  1,135 lines
  1.  
  2.  
  3.  
  4.  
  5. UTILITIES
  6.  
  7.     NOTE: Throughout this section reference is made to the CLI.
  8.           The CLI is the same thing as the Shell.  I was just too
  9.           lazy to update everything :)
  10.  
  11.     The A64 Package comes with a number of utility programs that are
  12.     designed to compliment A64.  The following list gives a brief
  13.     summary of the utilities included with The A64 Package.  A couple
  14.     of the headings need explanation.  The heading HDW is short for
  15.     HarDWare interface and is used to signify if the utility directly
  16.     needs A64's hardware interface.  The heading ENV is short for
  17.     ENVironment and is used to state what environment the utility
  18.     is to be used in.  The different environments are: WB - the
  19.     utility is meant to be used with the WorkBench, but can also be
  20.     used from the CLI, CLI - the utility is used from the CLI only,
  21.     C64 - the utility is meant to be used on the C64, and A64 - the
  22.     utility can be used by both A64 and the C64.  Please note that
  23.     the utilities with their environment set to C64 or A64 are actual
  24.     Commodore 64 programs, all other utilities are Amiga programs.
  25.     Also note that just because a utility does not use the hardware
  26.     interface directly does not mean that the utility will be useful
  27.     without the interface.  For example the utility "Pet2ASCII" will
  28.     convert a file from PetASCII to ASCII, but to use it you must
  29.     first transfer a C64 program to an Amiga disk.  Also note that
  30.     although most programs state that they should be run from the
  31.     CLI most of them can be accessed from the WorkBench with the
  32.     utility "64Tools."
  33.  
  34.     UTILITY NAME   HDW  ENV    FUNCTION
  35.     ------------   ---  ---    --------
  36.     64Tools        YES  WB     WorkBench interface to most other utils
  37.     64Cmd          YES  CLI    Send a command to a C64 drive
  38.     64Dir          YES  CLI    Read the dir of a C64 drive
  39.     64Print        YES  CLI    Print an Amiga file to a C64 printer
  40.     64Status       YES  CLI    Read a C64 drives' status
  41.     64ToAmiga      YES  CLI    Copy a file from a C64 drive to an
  42.                                Amiga drive
  43.     AmigaTo64      YES  CLI    Copy a file from an Amiga drive to a
  44.                                C64 drive
  45.     GrabGO64ROMs   NO   WB     Grab C64 ROMs from GO-64! V2.0 
  46.     Pet2ASCII      NO   CLI    Convert a file from PetASCII to ASCII
  47.     ASCII2Pet      NO   CLI    Convert a file from ASCII to PetASCII
  48.     PrintFile      NO   WB     Print Amiga file(s) to an Amiga
  49.                                printer
  50.     StripLoadAddr  NO   CLI    Strip the load address from a file
  51.     64Colors       NO   A64    View the C64's colors
  52.     SaveROMs       NO   C64    Save the C64's ROMs
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                                                  5-1
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. CONVENTIONS FOR THE CLI BASED UTILITIES
  69.  
  70.     Here are some general conventions for using the CLI based
  71.     utilities that will help make them easier to use:
  72.  
  73.     For all the CLI based utilities except one, 64Status, you may
  74.     enter the utilities name alone to get it's usage (for 64Status
  75.     enter ? after its name to get its usage).
  76.  
  77.         For example, if you type: 64ToAmiga [RETURN]
  78.  
  79.         The utility will print a short copyright message followed by
  80.         a usage line that shows the syntax of the input that the
  81.         utility expects.  A usage line appears like this:    
  82.  
  83.         Usage: 64ToAmiga <source filename> <destination filename>
  84.             [file type]
  85.  
  86.     A utilities usage line shows what parameters are needed by the
  87.     utility and encloses these parameters with symbols:
  88.  
  89.         When you see a parameter enclosed in < > this parameter is
  90.         required by the utility and must be entered for the utility
  91.         to function properly.
  92.  
  93.         When you see a parameter enclosed in [ ] this parameter is
  94.         optional. If you don't enter anything for this parameter the
  95.         utility will use some default value for it.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                                                  5-2
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. 64Tools
  132.  
  133.     The 64Tools utility is actually a WorkBench interface to most of
  134.     The A64 Package's CLI based utilities.  This means that 64Tools
  135.     doesn't actually perform the functions of the CLI based
  136.     utilities, it allows you to run the CLI based utilities from the
  137.     WorkBench.  64Tools allows Amiga users who are not familiar with
  138.     the CLI to access all of The A64 Packages utilities.  64Tools
  139.     also adds some features that are not available when using the CLI
  140.     utilities by themselves, like transferring multiple files from a
  141.     C64 disk to an Amiga disk.
  142.  
  143.     NOTE: 64Tools was written while using V2.0 of the OS, if you are
  144.           using it with V1.3 the colors of the window will not appear
  145.           exactly as intended.
  146.  
  147.     64Tools can be run from either the WorkBench or CLI.  To run it
  148.     from the WorkBench double-click its icon in the A64Utilities
  149.     drawer.  To run it from the CLI you should first set your
  150.     current directory to the A64Utilities drawer.
  151.  
  152.     When you run run 64Tools a window will open on the WorkBench
  153.     screen.  In this window will be many gadgets that allow you to
  154.     access The A64 Packages utilities and perform related operations.
  155.     Basically 64Tools' gadgets can be broken into two sections: All
  156.     the gadgets that relate to transferring files from C64 disks to
  157.     Amiga disks and all the other gadgets that relate to the rest of
  158.     The A64 Packages utilities.
  159.  
  160. DRIVE GADGET
  161.  
  162.     The Drive gadget allows you to pick the current C64 drive that
  163.     you are using with 64Tools.  It has four possible settings: 8, 9,
  164.     10 and 11.  These settings correspond to the C64's drive numbers.
  165.     The drive gadget effects all of the utility programs that use A64's
  166.     interface except 64Print.
  167.  
  168.     Note that the Drive gadget is different than all the other
  169.     gadgets because it not only effects transferring file from C64
  170.     disks to Amiga disks, but also the other utilities that use C64
  171.     drives as well.
  172.  
  173. PATTERN GADGET
  174.  
  175.     The Pattern gadget is used to enter a C64 wildcard pattern when
  176.     reading the directory of a C64 disk.  For example if you enter
  177.     "$:c*" and then selected the New Disk gadget (discussed below)
  178.     64Tools would read the directory of the current C64 drive and
  179.     would only list list the files that began with "c."
  180.      
  181.     Anytime you change the Pattern gadget you must select the New
  182.  
  183.  
  184.                                                                  5-3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.     Disk gadget to get a new directory listing using the wildcard
  195.     pattern.
  196.  
  197. NEW DISK GADGET
  198.  
  199.     The New Disk gadget allows you to read the directory of the
  200.     current C64 drive.  Anytime you change the Drive gadget, Pattern
  201.     gadget or put a new disk in the C64 drive you must select the New
  202.     Disk gadget to get a new directory listing
  203.  
  204. FILE GADGETS
  205.  
  206.     Covering most of the left side of the 64Tools window is an area
  207.     used to display the directory of a C64 disk.  This area works
  208.     just like a standard file requester does.  It displays a number
  209.     of files in the directory and allows you to scroll through the
  210.     entire directory by using the scroll and arrow gadgets just to
  211.     the right of the file area.  Each file in the directory will
  212.     be displayed by showing its size (in C64 blocks), name and file
  213.     type.  You select or unselect a file in the directory by clicking
  214.     on its name.  Selected files will be transferred when the Start
  215.     gadget is selected (discussed below).  64Tools is unable to
  216.     transfer USR or REL files so files with these file types will be
  217.     disabled in the directory listing and you will be unable to
  218.     select them.
  219.  
  220. INCLUDE ALL GADGET
  221.  
  222.     The Include All gadget allows you to select all the files in
  223.     the directory list.
  224.  
  225. EXCLUDE ALL GADGET
  226.  
  227.     The Exclude All gadget allows you to unselect all the files in
  228.     the directory list.
  229.  
  230. DESTINATION GADGET
  231.  
  232.     The Destination gadget allows you to enter the name of the drive
  233.     or directory that you want to transfer C64 files to.  For Example
  234.     if you enter "df1:" then when you select the Start gadget all of
  235.     the selected files in the directory will be transferred to drive
  236.     df1:.
  237.  
  238. START GADGET
  239.  
  240.     The Start gadget allows you to start the file transfer from a C64
  241.     drive to an Amiga drive.  All the selected files will be copied
  242.     from the C64 drive to the Amiga drive you specified in the
  243.     Destination gadget.
  244.  
  245.  
  246.  
  247.                                                                  5-4
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. AMIGATO64 GADGET
  258.  
  259.     The AmigaTo64 gadget allows you to transfer a file from an Amiga
  260.     disk to a C64 disk.  When you select this gadget a requester will
  261.     appear asking you to enter the parameters that 64Tools should
  262.     pass to the 64ToAmiga utility.  See the 64ToAmiga utility section
  263.     for more information on what these parameters should be.
  264.  
  265. 64STATUS GADGET
  266.  
  267.     The 64Status gadget allows you to read the status of a C64 drive.
  268.  
  269. 64CMD GADGET
  270.  
  271.     The 64Cmd gadget allows you to send drive commands to a C64
  272.     drive.  This allows you to do a variety of useful things like
  273.     formatting C64 disks and deleting files.  When you select this
  274.     gadget a requester will appear asking you to enter the
  275.     parameters that 64Tools should pass to the 64Cmd utility.  See
  276.     the 64Cmd utility section for more information on what these
  277.     parameters should be.
  278.  
  279. 64PRINT GADGET
  280.  
  281.     The 64Print gadget allows you to print an Amiga file to a C64
  282.     printer.  When you select this gadget a requester will appear
  283.     asking you to enter the parameters that 64Tools should pass to
  284.     the 64Print utility.  See the 64Print utility section for more
  285.     information on what these parameters should be.
  286.  
  287. STRIPLOADADDR GADGET
  288.  
  289.     The StripLoadAddr gadget allows you to strip the load address
  290.     from a C64 program that has been transferred to an Amiga disk.
  291.     When you select this gadget a requester will appear asking you to
  292.     enter the parameters that 64Tools should pass to the
  293.     StripLoadAddr utility.  See the StripLoadAddr utility section for
  294.     more information on what these parameters should be.
  295.  
  296. PET2ASCII GADGET
  297.  
  298.     The Pet2ASCII gadget allows you to convert a C64 file, that has
  299.     been transferred to an Amiga disk, from PetASCII to ASCII.  When
  300.     you select this gadget a requester will appear asking you to
  301.     enter the parameters that 64Tools should pass to the Pet2ASCII
  302.     utility.  See the Pet2ASCII utility section for more information
  303.     on what these parameters should be.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.                                                                  5-5
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320. ASCII2PET GADGET
  321.  
  322.     The ASCII2Pet gadget allows you to convert an Amiga file from
  323.     PetASCII to ASCII.  When you select this gadget a requester will
  324.     appear asking you to enter the parameters that 64Tools should
  325.     pass to the ASCII2Pet utility.  See the ASCII2Pet utility section
  326.     for more information on what these parameters should be.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                                                                  5-6
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383. 64Cmd
  384.  
  385.     PURPOSE:     Send a drive command to a C64 disk drive
  386.  
  387.     USAGE:       64Cmd <command string> [drive]
  388.                  <command string> is a valid C64 drive command
  389.                      string.
  390.                  [drive] is a C64 drive, specified as df8:, df9:,
  391.                      df10: or df11:.  df8: is the default.
  392.  
  393.     ENVIRONMENT: CLI
  394.  
  395.     INTERFACE:   YES
  396.  
  397.     64Cmd will allow you to send a command to a C64 disk drive.  It
  398.     supports all of the standard Commodore DOS commands.  Some
  399.     examples of using 64Cmd are:
  400.  
  401.         FUNCTION: Format a disk
  402.         USAGE:    64Cmd N0:<disk name>,<2 digit id> [C64 drive]
  403.         EXAMPLE:  64Cmd N0:testdisk,64 df8:
  404.  
  405.         FUNCTION: Delete a file
  406.         USAGE:    64Cmd S0:<filename> [C64 drive]
  407.         EXAMPLE:  64Cmd S0:testfile df8:
  408.  
  409.         FUNCTION: Rename a file
  410.         USAGE:    64Cmd R0:<new name>=<old name> [C64 drive]
  411.         EXAMPLE:  64Cmd R0:testfile2=testfile1 df8:
  412.  
  413.     For more information on C64 drive commands see your 1541 disk
  414.     drive user's manual.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.                                                                  5-7
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446. 64Dir
  447.  
  448.     PURPOSE:     Get a directory listing of a C64 disk
  449.  
  450.     USAGE:       64Dir <pattern> [drive]
  451.                  <pattern> is a valid C64 wildcard pattern string.
  452.                  [drive] is a C64 drive, specified as df8:, df9:,
  453.                      df10: or df11:.  df8: is the default.
  454.  
  455.     ENVIRONMENT: CLI
  456.  
  457.     INTERFACE:   YES
  458.  
  459.     64Dir will allow you to get a directory of a C64 disk.  Some
  460.     examples of using 64Dir are:
  461.  
  462.          64Dir $ df8:
  463.  
  464.              Will list the entire directory of drive 8.
  465.  
  466.          64Dir $:a* df9:
  467.  
  468.              Will list only the files that begin with "a" on drive 9.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.                                                                  5-8
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509. 64Print
  510.  
  511.     PURPOSE:     Print an Amiga file to C64 printer
  512.  
  513.     USAGE:       64Print <filename> <device> [opt]
  514.                  <filename> is the name of the Amiga file you want to
  515.                      print.
  516.                  <device> is a C64 printer number, either 4 or 5.
  517.                      The default is 4.
  518.                  [option] can be either A for ASCII or B for Binary.
  519.                      The default is A.  The difference between these
  520.                      options is that A will convert the file from
  521.                      ASCII to PetASCII before printing it and B will
  522.                       not do any conversion of the file.
  523.  
  524.     ENVIRONMENT: CLI
  525.  
  526.     INTERFACE:   YES
  527.  
  528.     64Print allows you to print an Amiga file to a C64 printer.  Some
  529.     examples of using 64Print are:
  530.  
  531.          64Print testfile 4
  532.  
  533.             Will print the Amiga file "testfile" to printer 4 and
  534.             will convert the output from ASCII to PetASCII.
  535.  
  536.          64Print testfile2 5 B
  537.  
  538.             Will print the Amiga file "testfile2" to printer 5 and
  539.             will not do any ASCII conversions to the output.
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.                                                                  5-9
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572. 64Status
  573.  
  574.     PURPOSE:     Read a the status of a C64 disk drive
  575.  
  576.     USAGE:       64Status [drive]
  577.                  [drive] is a C64 drive, specified as df8:, df9:,
  578.                      df10: or df11:.  df8: is the default.
  579.  
  580.     ENVIRONMENT: CLI
  581.  
  582.     INTERFACE:   YES
  583.  
  584.     64Status allows you to read the status of a C64 disk drive.  When
  585.     a C64 drive encounters an error it will flash its access light
  586.     off and on.  You can use 64Status to find out what caused the
  587.     error.  An example of 64Status is:
  588.  
  589.         64Status df8:
  590.  
  591.             Will read the status of drive 8.
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.                                                                  5-10
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635. 64ToAmiga
  636.  
  637.     PURPOSE:     Copy a file from a C64 drive to an Amiga drive.
  638.  
  639.     USAGE:       64ToAmiga <source filename> <destination filename>
  640.                      [file type]
  641.                  <source filename> is a C64 drive and filename.
  642.                  <destination filename> is an Amiga filename.
  643.                  [file type] can be either P for PRG file or S for
  644.                      SEQ file.  The default is P.
  645.  
  646.     ENVIRONMENT: CLI
  647.  
  648.     INTERFACE:   YES
  649.  
  650.         64ToAmiga will allow you to copy a file from a C64 disk drive
  651.         to an Amiga disk drive.  Some examples of using 64ToAmiga
  652.         are:
  653.  
  654.             64ToAmiga df8:testfile df0:testfile
  655.  
  656.                 Will copy the file "testfile" from the C64 drive 8 to
  657.                 the Amiga drive 0.
  658.  
  659.             64ToAmiga df9:testfile2 df0:64Prgs/testfile S
  660.  
  661.                 Will copy the sequential file "testfile2" from the
  662.                 C64 drive 9 to the file "testfile" in the directory
  663.                 64Prgs on Amiga drive 0.
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.                                                                  5-11
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698. AmigaTo64
  699.  
  700.     PURPOSE:     Copy a file from an Amiga drive to a C64 drive
  701.  
  702.     USAGE:       AmigaTo64 <source filename> <destination filename>
  703.                      [file type]
  704.                  <source filename> is an Amiga filename.
  705.                  <destination filename> is a C64 drive and filename.
  706.                  [file type] can be either P for PRG file or S for
  707.                      SEQ file.  The default is P.
  708.  
  709.     ENVIRONMENT: CLI
  710.  
  711.     INTERFACE:   YES
  712.  
  713.         AmigaTo64 will allow you to copy a file from an Amiga disk
  714.         drive to a C64 disk drive.  Some examples of using AmigaTo64
  715.         are:
  716.  
  717.             AmigaTo64 df0:testfile df8:testfile
  718.  
  719.                 Will copy the file "testfile" from the Amiga drive 0
  720.                 to the C64 drive 8.
  721.  
  722.             AmigaTo64 df0:64Prgs/testfile df9:testfile2 S
  723.  
  724.                 Will copy the file "testfile" from the directory
  725.                 64Prgs on the Amiga drive 0 to the sequential file
  726.                 "testfile2" on the C64 drive 9.
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.                                                                  5-12
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761. GrabGO64ROMs
  762.  
  763.     PURPOSE:     Grab the C64 ROMs from GO-64! V2.0
  764.  
  765.     USAGE:       GrabGO64ROMs
  766.  
  767.     ENVIRONMENT: Workbench or CLI
  768.  
  769.     INTERFACE:   NO
  770.  
  771.     NOTE:        To use this utility you must have an original copy
  772.                  of GO-64! V2.0.
  773.  
  774.     GrabGO64ROMs will allow you to "grab" the C64 ROMs from GO-64!
  775.     V2.0.  This can greatly simplify the process of installing the
  776.     C64 ROMs into A64 (See ROMs in the TECHNICAL section).
  777.  
  778.     When you run GrabGO64ROMs a window will open and you will be
  779.     prompted to insert the GO-64! V2.0 disk in any drive.  After
  780.     doing so GrabGO64ROMs will read the ROMs off the GO-64! disk
  781.     and then prompt you to enter the name of the directory to save
  782.     the ROMs to.  If you are using the standard configuration of The
  783.     A64 Package (Disk #1 is named A64), enter "A64:TheA64Pacakge."
  784.     GrabGO64ROMs will then install the C64 ROMs on your A64 disk.    
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.                                                                  5-13
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824. Pet2ASCII
  825.  
  826.     PURPOSE:     Convert an Amiga file from PetASCII to ASCII.
  827.  
  828.     USAGE:       Pet2ASCII <source filename> [destination filename]
  829.                  <source filename> is the name of the file you want
  830.                      to convert
  831.                  [destination filename] is the name of the file you
  832.                      want to output the converted file to.  If not
  833.                      specified then <source filename> will be
  834.                      overwritten by the converted file.
  835.  
  836.     ENVIRONMENT: CLI
  837.  
  838.     INTERFACE:   NO
  839.  
  840.     Pet2ASCII will allow you to convert an Amiga file from PetASCII
  841.     to standard ASCII.  The C64 does not use standard ASCII.  "ASCII"
  842.     stands for "American Standard Code for Information Interchange"
  843.     and is a standardized method for the way that many computers
  844.     represent certain information, namely english text.  This manual
  845.     was written on an Amiga which uses ASCII codes to represent each
  846.     letter and symbol.  The C64 has it's own form of ASCII called
  847.     PetASCII.  The Commodore 64's PetASCII is quite a bit different
  848.     from standard ASCII and for the Amiga to represent it correctly
  849.     it must be converted to standard ASCII.
  850.  
  851.     Some examples of Pet2ASCII's usage are as follows:
  852.  
  853.         Pet2ASCII testfile
  854.  
  855.              Will covert the file "testfile" from PetASCII to ASCII.
  856.  
  857.         Pet2ASCII testfile testfile.asc
  858.  
  859.             Will covert the file "testfile" from PetASCII to ASCII,
  860.             leaving the file "testfile" unchanged and the converted
  861.             file in "testfile.asc."
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.                                                                  5-14
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887. ASCII2Pet
  888.  
  889.     PURPOSE:     Convert an Amiga file from ASCII to PetASCII.
  890.  
  891.     USAGE:       ASCII2Pet <source filename> [destination filename]
  892.                  <source filename> is the name of the file you want
  893.                      to convert
  894.                  [destination filename] is the name of the file you
  895.                      want to output the converted file to.  If not
  896.                      specified then <source filename> will be
  897.                      overwritten by the converted file.
  898.  
  899.     ENVIRONMENT: CLI
  900.  
  901.     INTERFACE:   NO
  902.  
  903.     ASCII2Pet will allow you to convert an Amiga file from standard
  904.     ASCII to PetASCII.  Some examples of Pet2ASCII's usage are as
  905.     follows:
  906.  
  907.         ASCII2Pet testfile
  908.  
  909.              Will covert the file "testfile" from ASCII to PetASCII.
  910.  
  911.         ASCII2Pet testfile testfile.pet
  912.  
  913.             Will covert the file "testfile" from ASCII to PetASCII,
  914.             leaving the file "testfile" unchanged and the converted
  915.             file in "testfile.pet."
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.                                                                  5-15
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950. PrintFile
  951.  
  952.     PURPOSE:     Print one or more Amiga files to an Amiga printer.
  953.  
  954.     USAGE:       PrintFile [filename1] [filename2] [filename3] ...
  955.  
  956.     ENVIRONMENT: WorkBench or CLI
  957.  
  958.     INTERFACE:   NO
  959.  
  960.     PrintFile will allow you to print one or more files to an Amiga
  961.     printer.  It can be used from either the CLI or the WorkBench.
  962.     To use it from the WorkBench double-click its icon and then enter
  963.     the name of the file you wish to print.  After entering the
  964.     filename press the RETURN key to print the file.  You can also
  965.     pass PrintFile one or more filenames by selecting the document
  966.     icons that represent the files that you want to print and holding
  967.     down one of the SHIFT keys while double-clicking the PrintFile
  968.     icon.  For example if you want to print the files "ReadMe1st" and
  969.     "Registration.form."
  970.  
  971.         1. Press one of the shift keys on the Amiga keyboard.
  972.         2. Select the ReadMe1st icon by clicking the left mouse
  973.            button on it once.
  974.         3. Select the Registration.form icon by clicking the left
  975.            mouse button on it once.
  976.         4. Double-click the PrintFile icon while still holding down
  977.            the shift key.
  978.  
  979.     PrintFile will then be started and automatically start printing
  980.     the files.  Using this method it is possible to print all of The
  981.     A64 Packages documentation at once, but be warned, The A64
  982.     Package's entire manual is around 120 pages in length and will
  983.     take some time to print.
  984.  
  985.     To run PrintFile from the CLI enter the following:
  986.  
  987.         PrintFile [filename1] [filename2] [filename3]
  988.  
  989.     PrintFile will then be started and automatically start printing
  990.     the file(s) you specified.
  991.  
  992.     When PrintFile is done printing a file it does not close itself.
  993.     This allows you to print multiple files without restarting it.
  994.     To quit PrintFile select the close gadget at the top left hand
  995.     corner of its window.
  996.  
  997.  
  998.         
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                                                  5-16
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013. StripLoadAddr
  1014.  
  1015.     PURPOSE:     Strip the load address from a C64 program that has
  1016.                  been transferred to an Amiga disk.
  1017.  
  1018.     USAGE:       StripLoadAddr <filename>
  1019.                  <filename> is the name of the file you want to strip
  1020.                  the load address from.
  1021.  
  1022.     ENVIRONMENT: CLI
  1023.  
  1024.     INTERFACE:   NO
  1025.  
  1026.     StripLoadAddr will allow you to strip the load address from a C64
  1027.     program that has been transferred to an Amiga disk.  The C64 adds
  1028.     a two byte load address to the start of its PRG files that tells
  1029.     it where to load the file.  When transferring these files to the
  1030.     Amiga you may wish to strip this load address.  NOTE: If you plan
  1031.     on loading a transferred PRG file into A64 from an Amiga disk, you
  1032.     should NOT strip the load address from the file.  If you do, A64
  1033.     will not know where to load the file.  StripLoadAddr should only
  1034.     be used when installing the C64 ROMs (See installing the C64 ROMs
  1035.     in the TECHNICAL section) or if you specifically want to strip
  1036.     the load address for some reason of you own, another words if you
  1037.     are only transferring programs so they can be used in A64 you do
  1038.     NOT need to use this command on the transferred files.
  1039.  
  1040.     An example of using StripLoadAddr is:
  1041.  
  1042.         StripLoadAddr BASIC.rom
  1043.  
  1044.             Will strip the load address from the file "BASIC.rom"
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.                                                                  5-17
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076. C64 PROGRAMS
  1077.  
  1078.     The A64 Package comes with a couple of Commodore 64 programs,
  1079.     located in the directory 64Prgs.  These programs are as follows:
  1080.  
  1081. SaveROMs
  1082.  
  1083.     SaveROMs is for saving the C64 ROMs to disk.  It is meant to be
  1084.     run on a C64 because A64 does not contain the C64's ROMs.  To use
  1085.     this program see INSTALLING THE C64's ROMs in the TECHNICAL
  1086.     section.
  1087.  
  1088. 64Colors
  1089.  
  1090.     64Colors is a simple BASIC program that allows you to view the
  1091.     C64 colors.  It was included with The A64 Package so you could
  1092.     experiment with A64's COLOR MODES while using it (See COLORS in
  1093.     the A64Prefs section).
  1094.  
  1095.     For information on how to load and run this program see DRIVES in
  1096.     the SYSTEM MENU section.
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.                                                                  5-18
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.